home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / math / plotr80.zip / PLOTTER.DOC < prev    next >
Text File  |  1996-09-09  |  32KB  |  547 lines
  1.                             PLOTTER INSTRUCTIONS
  2.  
  3.      PLOTTER is an ASCII data plotting and evaluation program that can be
  4.      run on any PC/AT compatible computer with at least 640K bytes of RAM
  5.      and a standard CGA, EGA or VGA color monitor. Both Epson compatible
  6.      and HP LaserJet compatible printers are supported. Screen images of 
  7.      EGA and VGA plots can be saved to disk in PCX format for importing 
  8.      to word processors. If a MOUSE is detected in the system, it is 
  9.      automatically supported.
  10.  
  11.      If you want PLOTTER to load a data file at start-up time, you can
  12.      type PLOTTER FILENAME at the DOS prompt. The file will be read
  13.      as DATA FILE TYPE #1, and the program will start at the Options
  14.      Menu (see below). The DOS command line option makes it possible to
  15.      call PLOTTER from inside your own programs. For example, in BASIC
  16.      you would include the program line: SHELL "PLOTTER FILENAME".
  17.  
  18.      In general, default input responses are indicated by an asterisk
  19.      (*). Inputs that require key strokes not followed by ENTER are
  20.      indicated by square brackets []. Inputs that require ENTER to
  21.      complete the entry are indicated by parentheses (). You can back
  22.      out of most prompts in the program by pressing the ESCAPE key.
  23.  
  24.      The use of the MOUSE is intuitive throughout the program. Place
  25.      the MOUSE CURSOR on the item to be selected and click the LEFT
  26.      BUTTON. In general, the LEFT BUTTON is treated as an ENTER key
  27.      press, and the RIGHT BUTTON is treated as an ESCAPE key press.
  28.      You can use the MOUSE to answer single key prompts, such as [Y/*N]
  29.      or F2=LABEL, but most program inputs require use of the keyboard.
  30.  
  31.      For the menus in PLOTTER, you can use the UP and DOWN ARROW keys
  32.      to scroll through the items and press ENTER for your selection.
  33.      Or you can press the highlighted "hot key." To use your MOUSE,
  34.      place the CURSOR on the desired item and click the LEFT BUTTON.
  35.  
  36.      When you start PLOTTER you will see the Main Menu, consisting of
  37.      the following selections:
  38.  
  39.                          (R)ead Data File from Disk
  40.                          Create or (E)dit Data Files
  41.                          Change Plotter (S)etup
  42.                          (I)nstructions for Plotter
  43.                          Shell to D(O)S Environment
  44.                          (Q)uit the Program
  45.  
  46.      Press the (O) key to shell to DOS, and enter "exit" to return to
  47.      PLOTTER. Press (Q), ESCAPE, or the RIGHT MOUSE BUTTON to quit.
  48.  
  49.      Pressing (I) will let you read through the instructions for PLOTTER
  50.      contained in the ASCII text file PLOTTER.DOC (which is the document
  51.      you are presently reading). Use the UP and DOWN ARROW or PAGE keys
  52.      to move through the document. Place the MOUSE CURSOR on the top or
  53.      bottom border lines and click the LEFT BUTTON to scroll up or down
  54.      one line, or place the MOUSE CURSOR on the ARROW ICONS and click the
  55.      LEFT BUTTON to move up or down one page. The (I)nstructions feature
  56.      requires PLOTTER.DOC to be in the default directory.
  57.  
  58.                          (R)ead Data File from Disk
  59.  
  60.      You will be presented with a file selection menu that allows you to
  61.      navigate to all drives and directories. Use the UP/DN ARROW KEYS,
  62.      PAGE UP/DN, HOME/END or the MOUSE CURSOR to move the highlight bar
  63.      (selecting the ".." token moves you up one directory). You can select
  64.      a data file by pressing the ENTER key, or by DOUBLE-CLICKING the LEFT
  65.      MOUSE button, on the highlighted file. When you are done, the program
  66.      will take you to the Options Menu (see below). Press ESCAPE, or the
  67.      RIGHT MOUSE button, to enter a file name manually. You will see the
  68.      prompt "Enter the FILE NAME of your DATA SET." Press ESCAPE again to
  69.      cancel the (Read) option and return to the Main Menu.
  70.  
  71.      Use this option to read your data file(s) into PLOTTER. The program
  72.      can plot up to a total of 60,000 data values (for example, 30000 X-Y
  73.      pairs in one data set). For DATA FILE TYPE #1, the number of columns
  74.      in your data file, and the length of the file, will be automatically
  75.      determined as the data is read. For DATA FILE TYPE #2, you can select
  76.      up to 9 separate data files (from the file menu only), each with
  77.      different numbers of points and different X axis values. This can
  78.      be handy for "batch" processing a group of individual files.
  79.  
  80.                          Create or (E)dit Data Files
  81.  
  82.      Use this option to manually create or edit small data files. You
  83.      will be presented with the file selection menu (see above). If you
  84.      want to create a new data file, press ESCAPE and you will get the
  85.      prompt "Enter a FILE name for your DATA SET." Press ESCAPE, or the
  86.      RIGHT MOUSE BUTTON, again to cancel. If the file name you type in 
  87.      does not exist, you will be asked if you want to create it. You are
  88.      then taken to the data editing screen.
  89.  
  90.      Use the MOUSE CURSOR to position the editing cursor, scroll the data
  91.      screen (by clicking on the ARROW ICONS or the BORDER LINES) and select
  92.      options from the bottom status bar. The editing keys are as follows:
  93.  
  94.              ARROW KEYS .......... MOVE CURSOR OR SCROLL DATA
  95.              PAGE UP/DN .......... PREVIOUS/NEXT SCREEN
  96.              HOME/END ............ START/END OF A LINE
  97.              CTRL-HOME/END ....... START/END OF THE FILE
  98.              INSERT .............. TOGGLE INSERT/TYPEOVER
  99.              ENTER ............... START A NEW LINE
  100.              TAB ................. INSERT OR TYPEOVER 5 SPACES
  101.              DEL/BACKSPACE ....... DELETE DATA AND LINES
  102.              CTRL-Y .............. CUT CURRENT LINE INTO BUFFER
  103.              SHIFT-INS ........... PASTE SINGLE LINE FROM BUFFER
  104.              CTRL-X .............. SORT DATA BY X AXIS VALUES
  105.              ESCAPE .............. SAVE FILE AND OPTIONALLY QUIT
  106.  
  107.      Enter your data according to the format shown below in the des-
  108.      cription of the Change Plotter (S)etup option. The data on each line
  109.      must be separated by AT LEAST ONE SPACE. Note that PLOTTER cannot
  110.      use more than 10 columns of data, and that the maximum file length
  111.      is about 1200 lines. Make sure that your data is entered correctly.
  112.      For example, DO NOT include commas or non-numerical characters.
  113.      Press ESCAPE, or click the RIGHT MOUSE BUTTON, to the quit editor.
  114.      You will then have the chance to save any changes you have made.
  115.      Finally, the program takes you to the Options Menu (see below).
  116.  
  117.                          Change Plotter (S)etup
  118.  
  119.      Use this option to change the default settings in PLOTTER. The new
  120.      settings will remain in effect while the current session of PLOTTER
  121.      is running. The first prompt is "Select DATA FILE TYPE to read:"
  122.      PLOTTER can read two different file formats, as shown below. The
  123.      program initially defaults to DATA FILE TYPE #1. Note that all data
  124.      files must have the data separated by AT LEAST ONE SPACE.
  125.  
  126.      DATA FILE TYPE #1: Plot up to 10 columns of data from one file.
  127.  
  128.      X1   Y11   Y12  ..  Y1m   Data columns have a common X axis and
  129.      X2   Y21   Y22  ..  Y2m   the same number of points. You can
  130.      :     :     :   ..   :    redefine the X axis column. Max size
  131.      Xn   Yn1   Yn2  ..  Ynm   for the data is 60,000 real values.
  132.  
  133.      DATA FILE TYPE #2: Plot up to 9 separate X-Y data files.
  134.  
  135.      X1   Y1
  136.      X2   Y2    Data sets can have different X axis values and numbers
  137.      :    :     of points. Max data size for ALL sets is 60,000 values.
  138.      Xn   Yn
  139.  
  140.      The next prompt is "Select [X]-Y or [S]EMI-LOG plot:" PLOTTER de-
  141.      faults to X-Y plots. Press [S] to plot the X axis values as BASE
  142.      10 LOGARITHMS. Semi-Log plots are useful for data whose X axis
  143.      values span a range from small decimals to large whole numbers.
  144.      Note that PLOTTER automatically reverts to the default X-Y plot
  145.      type when you select the Curve Fitting or Signal Processing Menus.
  146.  
  147.      The third prompt is "Show